time

 NAME
  time - get current time

 SYNOPSIS
  time_t t = time(NULL);
          or
  time(&t);
  time_t t;

 FUNCTION
  time() returns the current time as a time_t and also copies it into
  a time_t if the address of said is passed as an argument.  You may
  pass NULL as an argument in which case the time is only returned.
 
  The time is returned as seconds since some base date, time_t is
  normally an unsigned long.

 EXAMPLE
  #include <stdio.h>
  #include <time.h>

  main()
  {
      time_t t = time(NULL);

      printf("t = %un", t);
      return(0);
  }

 INPUTS
  time_t *t;  pointer to a time_t or NULL

 RESULTS
  time_t t;   a time_t

 SEE ALSO
  localtime, asctime, strftime, ctime, clock